Release notes 2025

2025r4

Prevent or allow update of media assets using commercial API

In a previous version, it became possible to update media assets using the commercial API. However, this caused the API to become backwards incompatible.

From this version, by default, it is not possible anymore to update media assets using the API, but only create them. When using the POST /commercialPlaylist, POST /commercial and PUT /commercialBreak calls, it is checked if the media asset referenced in the mediaAssetId already exists:

• If so, the media asset information in the payload is ignored, and the BAPI service will log: Media asset information was ignored. The commercial API can only create media assets.

• If it does not exist, the media asset is created.

We would recommend not changing this behaviour; however, if this is absolutely required, an option can be activated to allow updating. Contact Mediagenix to activate this for you.

Drop-down list call for target groups of predicted ratings in commercial API

In a previous version, the predictedRatings array was added to the GET /breakSchedules of the commercial API. The YAML mentioned that the values of the targetGroup attribute could be retrieved with the GET /targetGroups call. However, this call was not part of the API.

From this version, the GET /targetGroups call has been added to the commercial API.

When the call is sent, it returns the API references and descriptions of the values of the TMCampaignTargetGroup drop-down list.

[
    {
        "id": "Adults",
        "name": "Adults"
    },
    {
        "id": "Kids",
        "name": "Kids"
    },
    {
        "id": "Teens",
        "name": "Teens"
    },
    {
        "id": "60+",
        "name": "60+"
    }
]

It can already be used, but will be added to the YAML in a future version.

Transmission title added to commercial API YAML

This information is mostly relevant for API developers.

In the previous version, the txTitle attribute was added to the GET /breakSchedule call of the commercial API, but it was not yet added to the YAML.

In this version, the txTitle was added to the properties of the Transmission schema of the YAML at line 734. The latest version can be retrieved by using the GET /api call.

2025r3

Transmission title in GET /breakSchedule call of commercial API

The commercial API contains a GET /breakSchedule call, which is used by the external system after publishing an interstitial schedule for interstitial integration. The call retrieves all transmissions and time allocations of the type specified in the interstitial integration definition for a channel on a specific date.

Previously, the transmissions array contained the productTitle and the seriesTitle, but not the title of the transmission itself, which can be different.

From this version, the txTitle attribute has been added to the response body of the GET /breakSchedule call. It maps to the head title of the transmission.

An example of the response:

{
    "channelId": "MGX",
    "startDate": "2025-11-01",
    "scheduleVersion": "Active",
    "dayStatus": "closed",
    "definitionId": "Comm",
    "transmissions": [
        {
            "transmissionId": "9501555641",
            "startTime": "09:33:00",
            "startTimeUTC": "08:33:00",
            "announcedStartTime": "09:25",
            "lockedStartTime": false,
            "duration": "01:28:30",
            "productId": "9501369293",
            "parentalRating": null,
            "txTitle": "FFG 2024 - Presence",
            "productType": "program",
            "productCode": null,
            "productTitle": "Presence",
            "seriesTitle": null,
            ...
            "timeAllocations": [
                {
                    "breakId": "000025",
                    "externalBreakId": null,
                    "startTime": "10:03:30",
                    "duration": "00:01:00",
                    "type": "commercial",
                    "position": "Middle",
                    "startTimeUTC": "09:03:30",
                    "readOnly": false,
                    "title": "Presence -  - Commercial",
                    "sequenceNumber": 4,
                    "regional": false,
                    "masterBreakId": null,
                    "predictedRatings": []
                }
            ]
        }
    ]
}